home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / traceprefix < prev    next >
Text File  |  2001-04-04  |  1KB  |  36 lines
  1. SYNOPSIS
  2.         string traceprefix(string prefix)
  3.         string traceprefix(int dummy)
  4.  
  5. DESCRIPTION
  6.         If called with a string, only objects matching this prefix will
  7.         be traced. The string must not contain a leading "/" because
  8.         the object names are stored internally without it. If called
  9.         with a number, the traceprefix will be ignored and all objects
  10.         will be traced. Returns the last traceprefix or 0 if there
  11.         wasn't any.
  12.  
  13.         The master-lfun valid_trace() is called with ("traceprefix", prefix)
  14.         as arguments to verify the use of this efun.
  15.  
  16. EXAMPLE
  17.         object obj;
  18.         string prefix;
  19.         obj = find_player("wessex");
  20.         prefix = object_name(obj);
  21.         prefix = prefix[1..strlen(prefix)-1]; /* cut off the leading "/" */
  22.         traceprefix(prefix);
  23.           /* From here on, only code in the object "std/player#69"
  24.            * will be traced.
  25.            */
  26.         trace(1|2|4|8);
  27.         ...
  28.         trace(0);
  29.  
  30. HISTORY
  31.         LDMud 3.2.9 passes the <prefix> argument to the valid_trace()
  32.             apply as well.
  33.  
  34. SEE ALSO
  35.         trace(E)
  36.